feat(app-shell): Connect an Agent asks which AI client you use and shows only its steps - #30943

Requested by Tesla · project thread

Fixes #30896

Clause-②: no
Metadata-protocol: none

维护者速读

• 改了什么：「连接智能体」页不再一次铺开七张卡片。端点与 SKILL.md 下载仍在最上方；其下先问「你用的是哪个 AI 助手？」（Claude、Codex、Cursor、WorkBuddy、豆包工作、千问办公），只显示所选那一个的步骤，切换一次点击，本浏览器记住选择；API 密钥表单移到底部折叠的「高级：脚本与 CI」。
• 为什么改：一个人只用一个客户端，原来要翻过另外六个客户端的说明才找到自己的步骤，API 密钥卡还混在客户端中间。实测页面主体从 1604 px 降到 664 px 高。
• 风险与回滚：只动这一个页面组件和新增的三条文案；选择存在本地浏览器（os:pref:connect.client），读不到时回到 Claude。密钥签发逻辑原样未改。回滚即 revert 本 PR。
• 先看：ui/packages/app-shell/src/console/connect/ConnectAgentWidget.tsx（Tabs 与 Collapsible 两处）、connectClientPreference.ts、测试文件末尾新增的 describe。
• 两分钟验证：打开 设置 → Connect an Agent，点「Codex」，刷新页面仍停在 Codex；点「高级：脚本与 CI」才出现 API 密钥表单。
• 需要你做的：无，席位落地。
• 席位意见：ui 席 2 对照 head 953cfc49 的 diff 复核：14 个文件、+448 / −207，无受治理路径。各客户端步骤、片段与提示文字原样搬进 Tabs，只渲染所选一个；选择经控制台既有的偏好存储（user 范围，os:pref:connect.client）保存，读不到或已不提供的客户端回到 Claude；API 密钥卡整体移入默认折叠的「高级：脚本与 CI」，签发与确认逻辑未改，签发结果状态在父组件，折叠不会丢失。席位核对时更正了 changeset 里新增文案的条数（三条），此外无改动。CI 全绿，Clause-② no，不欠契约复审。同意落地。

What changes

• ConnectAgentWidget.tsx: under the endpoint card (URL, copy, SKILL.md download — unchanged, on top for everyone), a card asks "Which AI assistant do you use?" and holds a Tabs picker from @object-ui/components with the six clients in the order the page offered them. Only the chosen client's steps render; every client's steps, snippets and hints are the same text as before. The API key card moves into a Collapsible "Advanced: scripts and CI" at the bottom, closed by default; its mint/confirm logic is unchanged.
• connectClientPreference.ts (new): the client ids and the reader's choice, declared through the console's one preference store (utils/workspacePreference.ts, imported, not edited), user scope, stored as {"client":"CLIENT_ID","v":1} under os:pref:connect.client. A stored id the page no longer offers, an unreadable record, or storage that throws reads as no choice → Claude. The store already wraps every storage access in try/catch.
• i18n: three new keys (connectAgent.client.title, connectAgent.client.hint, connectAgent.advanced.title) in all ten console packs. PR feat(i18n)!: the Console's language packs follow the platform locale table, keyed by its tags, and Traditional Chinese (zh-Hant) ships #30902 is not on main, so they sit in today's zh.ts / pt.ts.
• Root changeset .changeset/30896-connect-agent-client-picker.md (@object-ui/app-shell, @object-ui/i18n: patch).

Tests

ConnectAgentWidget.keyName-13355.test.tsx (the component's one harness file):

• the three key-name cases open the Advanced section first, then assert as before;
• the Chinese-clients block now walks the picker: tab order, each client's body + hint on pick, each client's transport spelling;
• new top-level describe: endpoint + SKILL.md on top, Claude only with no choice, key form collapsed until opened; one click switches and the choice is stored and read back after remount; an unknown stored client reads as Claude.

Acceptance notes

• With no stored choice the picker opens on Claude rather than on an empty state; the card asks the question in the card heading and shows the first client's steps.
• The Chinese clients' hints still say "(create a key below)"; the key form is below, now behind the Advanced trigger. Connect an Agent never says what an assistant can do once connected, or whether the connection worked #30898 rewrites this copy.
• No widget heading follows the Connect an Agent is buried in Setup and in a collapsed Account group; put it where each person looks, and call it Connect an AI Assistant #30895 rename: the widget has none, the page title is metadata.
• Three no-explicit-any lint warnings in the file are pre-existing lines that moved.

Verification

Head 6111073f (my commit 181fd4df + merge of origin/main 33043bd8, no overlap with this diff).